home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xvc / XSGIvcSetChannelInputRectangle.z / XSGIvcSetChannelInputRectangle
Encoding:
Text File  |  2002-10-03  |  6.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSGIvcSetChannelInputRectangle,
  10.           XSGIvcQueryBestChannelRectangle - Video Pan and Zoom
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXX11111111////eeeexxxxtttteeeennnnssssiiiioooonnnnssss////XXXXSSSSGGGGIIIIvvvvcccc....hhhh>>>>
  14.  
  15.           vvvvooooiiiidddd XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
  16.               iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
  17.               iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
  18.               XXXXSSSSGGGGIIIIvvvvccccRRRReeeeccccttttaaaannnngggglllleeee rrrrcccctttt))))
  19.  
  20.           SSSSttttaaaattttuuuussss XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyBBBBeeeessssttttCCCChhhhaaaannnnnnnneeeellllRRRReeeeccccttttaaaannnngggglllleeee((((DDDDiiiissssppppllllaaaayyyy ****ddddiiiissssppppllllaaaayyyy,,,,
  21.               iiiinnnntttt ssssccccrrrreeeeeeeennnn,,,,
  22.               iiiinnnntttt cccchhhhaaaannnnnnnneeeellll,,,,
  23.               XXXXSSSSGGGGIIIIvvvvccccRRRReeeeccccttttaaaannnngggglllleeee rrrrcccctttt,,,,
  24.               XXXXSSSSGGGGIIIIvvvvccccRRRReeeeccccttttaaaannnngggglllleeee ****rrrrrrrrcccctttt))))
  25.  
  26.      PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  27.           _d_i_s_p_l_a_y     Specifies the connection to the X server.
  28.  
  29.           _s_c_r_e_e_n      Specifies the screen of the X server.
  30.  
  31.           _c_h_a_n_n_e_l     Specifies the channel number.
  32.  
  33.           _r_c_t         Specifies the origin or/and the size to which
  34.                       the rectangle should be set (specified in
  35.                       pixels).
  36.  
  37.           _r_r_c_t        Return the origin and the size of the rectangle
  38.                       (specified in pixels).
  39.  
  40.  
  41.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.           Each channel of an X server displays a rectangular region of
  43.           pixels of the root window.  In operation, the channel
  44.           fetches the specified input rectangle from the frame buffer.
  45.           On configurations with one channel, the input rectangle is
  46.           usually the size of the root window; however, some X server
  47.           video hardware permits the input rectangle to change origin
  48.           and size.
  49.  
  50.           To change the size or origin of the rectangle, use
  51.           XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee.  Both size and origin are required,
  52.           even if only one is changed.  To determine the current size
  53.           and origin, use the XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyCCCChhhhaaaannnnnnnneeeellllIIIInnnnffffoooo function.
  54.  
  55.           If an X server does permit changes to the input rectangle,
  56.           the server may impose restrictions on the values of both
  57.           size and origin.  The XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyBBBBeeeessssttttCCCChhhhaaaannnnnnnneeeellllRRRReeeeccccttttaaaannnngggglllleeee
  58.           function provides a means to determine the rectangle nearest
  59.           to the size and origin you specify.  Determination of the
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee((((3333))))XXXXSSSSGGGGIIIIvvvvccccSSSSeeeettttCCCChhhhaaaannnnnnnneeeellllIIIInnnnppppuuuuttttRRRReeeeccccttttaaaannnngggglllleeee((((3333))))
  71.  
  72.  
  73.  
  74.           best rectangle is server-dependent, and different situations
  75.           may yield different results.
  76.  
  77.  
  78.      EEEEVVVVEEEENNNNTTTTSSSS
  79.           When this control is altered, the server generates a
  80.           ChannelInputRectangle event.
  81.  
  82.  
  83.      RRRREEEETTTTUUUURRRRNNNNEEEEDDDD VVVVAAAALLLLUUUUEEEE
  84.           XXXXSSSSGGGGIIIIvvvvccccQQQQuuuueeeerrrryyyyBBBBeeeessssttttCCCChhhhaaaannnnnnnneeeellllRRRReeeeccccttttaaaannnngggglllleeee returns TRUE if a rectangle
  85.           is found of a valid supported size and origin (the valid
  86.           size of which is found in the returned variables); this
  87.           function returns FALSE when no valid rectangle was found
  88.           (among which is the case when the server does not support
  89.           change of size or origin).
  90.  
  91.           Parameter errors are reported via BadValue or BadMatch.
  92.  
  93.  
  94.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.           XSGIvc, XSGIvcQueryChannelInfo
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.